From d4c0cc886bd33ff2f53ac420dd3800ada3682ad6 Mon Sep 17 00:00:00 2001 From: Leopold Palomo-Avellaneda Date: Fri, 23 May 2014 13:04:25 +0200 Subject: [PATCH] Adding information for the debug package --- debian/README.Debug | 39 ++++++++++++++++++++++++++++++++++++ debian/libpcl1.7-dbg.install | 1 + 2 files changed, 40 insertions(+) create mode 100644 debian/README.Debug create mode 100644 debian/libpcl1.7-dbg.install diff --git a/debian/README.Debug b/debian/README.Debug new file mode 100644 index 00000000..a51a84d8 --- /dev/null +++ b/debian/README.Debug @@ -0,0 +1,39 @@ +Debug packages +====================================================================== + +This is a package with debug symbols. The purpose of a -dbg package +is to provide a mapping between binary addresses and source line +numbers/variable names, not to provide the source itself [1]. + +The source itself is in the source package, which can be installed with +"apt-get source $package" if you have a deb-src line in +/etc/apt/sources.list. This installs it in the current directory owned +by the current user (i.e. conveniently editable), while apt-get +install files are normally owned and editable only by root. + +It's working if your debug backtraces are of the form: + +#3 0x0000000000ed4188 in SGPropertyNode::set_string (this=0x7eaa480, + val=0x20d79a0 "Shaders/cloud-shadowfunc.frag") + at /home/palmer/fs_dev/git/simgear/simgear/props/props.cxx:511 + +(note the file name and line number) rather than + +#2 0x00007ffff5aef83d in g_input_stream_read () + from /usr/lib/x86_64-linux-gnu/libgio-2.0.so.0 +#3 0x00007ffff669c3e5 in ?? () + from /usr/lib/x86_64-linux-gnu/libgdk_pixbuf-2.0.so.0 + +To make useful this package install the corresponding source package +following the instructions above explained and configure gdb [2] to +use it, or qtcreator [3], or whatever IDE do you use. + + +Leopold Palomo-Avellaneda +May 2014 + +----- +[1] https://lists.debian.org/debian-mentors/2014/05/msg00194.html +[2] https://sourceware.org/gdb/onlinedocs/gdb/Source-Path.html +[3] http://qt-project.org/doc/qtcreator-2.8/creator-debugger-engines.html + diff --git a/debian/libpcl1.7-dbg.install b/debian/libpcl1.7-dbg.install new file mode 100644 index 00000000..ff42a9e4 --- /dev/null +++ b/debian/libpcl1.7-dbg.install @@ -0,0 +1 @@ +usr/share/doc/libpcl1.7-dbg/* -- 2.30.2